<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type"><title>Log for C++ Project</title>

<link rel="stylesheet" type="text/css" href="styles.css">
</head>
<body>
<div id="headerdiv">
<h1><a id="begin">Log for C++ Project</a></h1>
<!-- <a style="float: right;" href="http://sourceforge.net/"><img alt="Sourceforge" src="http://log4cpp.sourceforge.net/sflogo.png"> </a> -->
<hr class="delimiter"></div>
<div class="briefline">
&nbsp;| <span> <a href="http://log4cpp.sourceforge.net/">Log
for C++ Project
Page on Sourceforge</a>
</span> &nbsp;|
<span>Last Published:
2012-11-29</span> &nbsp;|</div>
<hr class="delimiter">
<div id="projectpage">
<div id="navigationpanel" class="lightbackground">
<h5>About log4cpp</h5>
<ul>
<li> <a title="What is log4cpp?" href="#whatis">What
is log4cpp?</a> </li>
<li> <a title="Download" href="#download">Download</a></li>
<li =""><a title="License" href="#license">License</a>
</li>
<li =""><a title="API Documentation" href="#apidoc">API Documentation</a> </li>
<li><a title="FAQ" href="#faq">FAQ</a>
</li>
</ul>
<h5>How to use</h5>
<ul>
<li><a title="Simple example" href="#simpleexample">Simple
example</a> </li>
<li><a title="Properties file example" href="#propfile">Properties
file example</a></li>
<li><a title="Building" href="#building">Building</a>
</li>
<ul>
<li>&nbsp; <a title="Linux/*nix" href="#buildlinux">Linux/*nix</a> </li>
<li>&nbsp; <a title="Windows" href="#buildwindows">Windows</a> </li>
</ul>
</ul>
<h5>Development</h5>
<ul>
<li><a title="CVS Repository" href="#cvs">CVS
Repository</a> </li>
<li><a title="Releases" href="#releases">Releases</a>
</li>
<li><a title="Status" href="#status">Status</a>
</li>
<li><a title="People" href="#people">People</a>
</li>
<li> <a title="Other projects" href="#other">Other
projects</a> </li>
</ul>
</div>
<div id="contentpanel">
<div class="chapter"><a id="whatis">
<h2>What is log4cpp?</h2>
</a>
<p>Log4cpp is library of C++ classes for flexible logging to
files, syslog, IDSA and other destinations.
It is modeled after the <a href="http://jakarta.apache.org/log4j">Log4j</a>
Java library, staying as close to their API as is reasonable.
</p>
<div class="chapter">
<a id="download">
<h2>Download</h2>
</a>
<p>Sources are available from SourceForges <a href="http://sourceforge.net/project/showfiles.php?group_id=15190">download
page</a>.<br>
We do not supply binaries, because of the numerous incompatible ABIs
(e.g. g++ 2.95 vs 2.96 vs 3.0 vs 3.2) and different package
formats.<br>
A stable but older version of log4cpp is available in Debian stable,
see <a href="http://packages.debian.org/stable/libs/">http://packages.debian.org/stable/libs/</a>.<br>
FreeBSD users can find log4cpp in the ports collection,
see <a href="http://www.freebsd.org/ports/devel.html">http://www.freebsd.org/ports/devel.html</a><br>
Log4cpp includes support for building RPMs, so building your own from
the source tar-ball is as simple as
</p>
<pre class="code">rpm -ta log4cpp-x.y.z.tar.gz<br></pre>
<p></p>
<a href="#begin">^</a>
</div>

<div class="chapter">
<h2><a id="building">Building Log4cpp</a></h2>
<h3><a id="buildlinux">Autoconf</a></h3>
<p>As of version 0.2.0 log4cpp can be build using autoconf on
platforms
that support it. Simply do:
</p>
<pre class="code">./configure<br>make<br>make check<br>make install<br></pre>
<p>This will install log4cpp under /usr/local. To install in
another localation specify --prefix=&lt;location&gt; when
running configure.
</p>
<h3>Options for ./configure</h3>
Besides the usual ./configure options like --prefix a few others are
available:
<dl>
<dt>--with-idsa</dt>
<dd>Include support for logging to IDSA (<a href="http://jade.cs.uct.ac.za/idsa/index.html">http://jade.cs.uct.ac.za/idsa/index.html</a>).
This will give you an IdsaAppender Appender class.</dd>
</dl>
<dl>
<dt>--with-omnithreads[=&lt;path-to-omniORB&gt;]</dt>
<dd>Enable multi-threading support using omniORB4's omniThreads
MT abstraction library (http://www.omniorb.org).
configure expects the omnithread header files to reside in
&lt;path-to-omniORB&gt;/include and the library in
&lt;path-to-omniORB&lt;/lib, i.e. not in a platform specific
subdirectory. Create symlinks where necessary.<br>
NB. omniORB4 is required: omniORB3 will not suffice as it lacks
sufficient support for thread specific data.
At the moment (August 2002) omniORB4 is in beta, however most parts and
specifically the threading
library appear to be quite stable.
</dd>
</dl>
<dl>
<dt>--with-pthreads</dt>
<dd>Enable multi-threading support using the 'pthread' POSIX
threads library.
This option is mutually exclusive with --with-omnithreads.</dd>
<dd></dd>
</dl>
<dl>
<dt>--enable-doxyen</dt>
<dd>Enables generation of API documentation by Dimitri van
Heeschs Doxygen tool
(http://www.doxygen.org/). Defaults to yes if doxygen can be found in
the
search path.</dd>
</dl>
<dl>
<dt>--enable-html-docs</dt>
<dd>If doxygen is enabled, have it generate HTML formatted
documentation.</dd>
</dl>
<dl>
<dt>--enable-latex-docs</dt>
<dd>If doxygen is enabled, have it generate LaTeX formatted
documentation.</dd>
</dl>
<dl>
<dt> --enable-dot</dt>
<dd>Let Doxygen use the 'dot' tool of GraphViz (<a href="http://www.graphviz.org/">http://www.graphviz.org</a>)
todraw its graphs.</dd>
</dl>
<dl>
<dt>--disable-remote-syslog </dt>
<dd>Exclude RemoteSyslogAppender from build (included by default)</dd>
</dl>
<dl>
<dt>--disable-smtp</dt>
<dd>Exclude SmtpAppender from build (included by default)</dd>
</dl>

<p></p>
<h3>Build notes for specific platforms</h3>
<dl>
<dt>*nix - g++ compiler</dt>
<dd>Log4cpp should build whitout modification on any decent
*nix system with g++ and GNU make. The primary development platform is
RedHat Linux 7.3, which has g++ 2.96-rh, but the aim is to be
compatible with from g++ 2.95 and up. When g++ 3.x has been widely
adopted we may drop support for older g++ versions.</dd>
</dl>
<dl>
<dt>Solaris - Sun CC compiler</dt>
<dd>Compilation with Suns CC compiler requires setting some
enviroment variables.
Also static libraries appear not to work. In short do:
<pre class="code">CC=CC CXX=CC LD="CC -KPIC" ./configure --disable-static<br></pre>
</dd>
</dl>
<dl>
<dt><a id="buildwindows">Win32 - VS2010</a></dt>
<dd>Use the workspace and project files in subdirectory msvc10.
(You may need to adjust include/log4cpp/config-win32.h and the project
files to your particular needs)</dd>
</dl>
<dl>
<dt>Win32 - MSVC++ 6</dt>
<dd>Use the workspace and project files in subdirectory msvc6.
You may need to adjust include/log4cpp/config-win32.h and the project
files to your particular needs.</dd>
</dl>

<dl>
<dt>Win32 - MSVC++ 5</dt>
<dd>Building log4cpp with MSVC++ 5 is not supported and will
not be,
unless someone can find a way to do so without mutilating the source
code.</dd>
</dl>
<dl>
<dt>Win32 - Borland C++ Builder 5</dt>
<dd>Use the project and make files in subdirectory bcb5.</dd>
</dl>
<dl>
<dt>Win32 - Cygwin</dt>
<dd>Use './configure; make; make install'.<br>
Be warned that there have been very few success or failure reports for
this platform,
so either it works very smoothly or noone actively uses log4cpp with
Cygwin :-)
</dd>
</dl>
<dl>
<dt>OpenVMS</dt>
<dt></dt>
<dd>Edit include/log4cpp/config-openvms.h if you need
different settings.<br>
This has been tested on OpenVMS Alpha v7.3 and Compaq C++ V6.3-020
only.
</dd>
<dd>1) Copy the src and include directory (including all its
contents and subdirectories) onto your OpenVMS system.</dd>
<dd>2) Compile each source file (*.CPP and *.C in the src
directory) one by one by the following command,
<pre class="code">cxx /include=("/a1\$dkb0/user/tony/project/log4cpp/include") /define=(__USE_STD_IOSTREAM,__OPENVMS__) /repository=a1$dkb0:[user.tony.project.log4cpp.repository] APPENDER.CPP<br>cxx /include=("/a1\$dkb0/user/tony/project/log4cpp/include") /define=(__USE_STD_IOSTREAM,__OPENVMS__) /repository=a1$dkb0:[user.tony.project.log4cpp.repository] APPENDERSKELETON.CPP<br></pre>
...etc<br>
Please substitute a correct path for your include directory. A
unix-style directory name is requied in the /include parameter.
In this example, the pathis A1$DKBO:[USER.TONY.PROJECT.LOG4CPP.INCLUDE]<br>
A repository directory is also specified here as
A1$DKB0:[USER.TONY.PROJECT.LOG4CPP.REPOSITORY].<br>
</dd>
<dd>3) Create a static library, LOG4CPP.OLB
<pre class="code">lib/create log4cpp<br></pre>
</dd>
<dd>4) Put all compiled OBJ files into the LOG4CPP.OLB
<pre class="code">lib/insert log4cpp appender<br>lib/insert log4cpp appenderskeleton<br></pre>
...etc<br>
</dd>
<dd>5) Link a program with log4cpp.olb. e.g:
<pre class="code">cxx /include=("/a1\$dkb0/user/tony/project/log4cpp/include") /define=(__USE_STD_IOSTREAM,__OPENVMS__) testlog4cpp.cxx<br>cxxlink /repository=a1$dkb0:[user.tony.project.log4cpp.repository] testlog4cpp,log4cpp/library<br></pre>
</dd>
</dl>
</dl>
<a href="#begin">^</a>
</div>

<div class="chapter">
<h2><a id="license">License</a></h2>
<p>As of version 0.2.1 this library is licensed under the Lesser
General Public License instead of the General Public License.
No further license changes are planned :-). </p>
<pre>Log for C++ (short name: log4cpp), a C++ library for flexible logging.<br>Copyright (C) 2000-2002 LifeLine Networks bv<br>Copyright (C) 2000-2002 Bastiaan Bakker<br>Portions Copyright others, see file THANKS and source code.<br>This library is free software; you can redistribute it and/or<br>modify it under the terms of the GNU Lesser General Public<br>License as published by the Free Software Foundation; either<br>version 2.1 of the License, or (at your option) any later version.<br>This library is distributed in the hope that it will be useful,<br>but WITHOUT ANY WARRANTY; without even the implied warranty of<br>MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU<br>Lesser General Public License for more details.<br>You should have received a copy of the GNU Lesser General Public<br>License along with this library; if not, write to the Free Software<br>Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA<br></pre>
<a href="#begin">^</a>
</div>

<div class="chapter">
<h2><a id="apidoc">API Documentation</a></h2>
<p>API Documentation generated by <a href="http://www.doxygen.org/" name="Doxygen">Doxygen</a>
can be found <a href="http://log4cpp.sourceforge.net/api/index.html">here</a>.<br>
The Solaris Developer Connection features an article by Mo Budlon on
using
log4cpp 0.2.x, called '<a href="http://developers.sun.com/solaris/articles/logging.html">Logging
and Tracing in C++ Simplified</a>'.
Recommended reading if you trying to figure out how to use log4cpp!
</p>
<a href="#begin">^</a>
</div>

<div class="chapter">
<h2><a id="faq">FAQ</a></h2>
<h3>1. GENERAL</h3>
<h4>1.1. What is Log for C++?</h4>
Log for C++ is a library of C++ classes for flexible logging to files,
syslog and other destinations. It is modeled after the Log for Java
library (http://jakarta.apache.org/log4j/), staying as close to their
API as is reasonable.
<h4>1.2. How is Log for C++ related to Log4j? Is it a straight
port?</h4>
Log for C++ strives to supply a similar interface for logging in C++ as
Log4j provides in Java. However the implementation is not a
translation of the Java code. So in that sense it is not a 'port' of
Log4j. Of course Log for C++ does owe many of its concepts to log4j.
<h4>1.3. What is the name of this project, 'Log for C++' or
'log4cpp'?</h4>
The 'official' long name of the project is 'Log for C++', but in
practice, the short name, 'log4cpp' has proven more convinient.
<h4>1.4. Under which license is Log for C++ available?</h4>
As of version 0.2.1 Log for C++ is released under the GNU Lesser
General Public License (LGPL).
Versions before that have been released under the GPL. See the license
discussion on the forum at SourceForge
for the motivations behind switching from GPL to LGPL.
<h4>1.5. Our legal department doesn't like the LGPL, can you
release Log for C++ under license XYZ?</h4>
No.<br>
Long answer: Technically it may be possible if every contributor
agrees,
which due to their growing number has become increasingly
difficult. But even if that could be overcome it will not happen.<br>
Of course the LGPL does grant you the opportunity to choose the GPL
instead of the LGPL, but I bet XYZ != GPL.
<h3>2. COMPILATION AND INSTALLATION</h3>
See <a href="#building">building</a><br>
<h3>3. USAGE</h3>
<h4>3.1. I've succesfully compiled log4cpp, now how do I use this
stuff?</h4>
Have a glance at <a title="Simple example" href="#simpleexample">Simple
example</a> and <a title="Properties file example" href="#propfile">Properties file example</a>.
For some small examples using log4cpp, see the 'tests' subdirectory.
Also see the documentation section for a pointer for API documentation
and more usage information. 
<h4>3.2. Is log4cpp thread-safe?</h4>
The same instance of the log4cpp::Category object (a logger) can be used from different threads simultaneously without explicit synchronization. Concurrent access to the appenders will be prevented by the logger object itself. It will lock internal mutex each time when it comes to writing into appenders. So, it is safe, for example, to write from the multiple threads to the same logger which appends to the same file.
Although, log4cpp is configured in such a way that two different loggers append to the same appender (it may be a file), then there will be no way for the logging framework to arrange proper addition and things can get mixed up. So this way of configuration is not recommended.
<h4>3.3. What are possible format characters for the custom log message?</h4>
PatternLayout supports following set of format characters:<br>
<li><b>%%</b> - a single percent sign</li>
<li><b>%c</b> - the category</li>
<li><b>%d</b> - the date\n
 Date format: The date format character may be followed by a date format
 specifier enclosed between braces. For example, %d{%H:%M:%S,%l} or %d{%d %m %Y %H:%M:%S,%l}.
 If no date format specifier is given then the following format is used:
"Wed Jan 02 02:03:55 1980". The date format specifier admits the same syntax
as the ANSI C function strftime, with 1 addition. The addition is the specifier
%l for milliseconds, padded with zeros to make 3 digits.</li>
      <li><b>%m</b> - the message</li>
      <li><b>%n</b> - the platform specific line separator</li>
      <li><b>%p</b> - the priority</li>
      <li><b>%r</b> - milliseconds since this layout was created.</li>
      <li><b>%R</b> - seconds since Jan 1, 1970</li>
      <li><b>%u</b> - clock ticks since process start</li>
      <li><b>%x</b> - the NDC</li>
      <li><b>%t</b> - thread name</li>
      
      By default, ConversionPattern for PatternLayout is set to "%m%n".<br>
<h3>4. PROBLEMS AND ERROR MESSAGES</h3>
<h4>4.1. I get 'Naming collision for 'ERROR' detected. Please
read the FAQ for a workaround.'</h4>
This is caused by the rudeness of some platforms, which mutilate the
namespace with some blunt #defines. To be more precise,
the Win32 API includes #defines of 'ERROR' and 'DEBUG'. Since the
preprocessor is unaware of C++ naming scopes this results in
reserving the words ERROR and DEBUG litterally everywhere. In
particular this conflicts with log4cpp::Prioritiy::ERROR and
log4cpp::Priority::DEBUG. These latter two names come from log4j, so
they are not something we made up ourselves.<br>
They Win32 authors should not have rudelessly claimed these generic
names through the preprocessor. There are much better alternatives:
<ol>
<li>If they use it as an integer constant, declare it using a
language construct.
Either '<tt>enum {ERROR=1};</tt>' or '<tt>static
const int ERROR=1;</tt>' would do fine.</li>
<li>Use a less generic name like WIN32API_ERROR to make naming
conflicts less likely</li>
<li>In case they use it as a flag for conditional compilation,
use '<tt>#define DEBUG DEBUG</tt>' and '<tt>#if
defined(DEBUG)</tt>'.
In that case the preprocessor would simply replace all occurrences of
'DEBUG' in the source code with 'DEBUG', in effect leaving
everything intact.</li>
</ol>
<p>Of course the proper solution would be if the offending party
would use one of the above methods, but we could have to wait
some time for this to actually happen. As an alternative log4cpp can
workaround these #defines. The workaround code is enabled by
doing <tt>#define LOG4CPP_FIX_ERROR_COLLISION 1</tt>
before #including any log4cpp header files and after #including all
platform headers. For Win32 platforms this #define has already been
included in log4cpp/config-win32.h.
</p>
<p>Once log4cpp has been updated to the log4j 1.2 API we can get
rid of this problem by adopting the new names for log levels.
</p>
<h4>4.2. I am trying to compile/link the log4cpp package using
the SunWorkshop compiler (CC) on a Solaris 7 machine.
The library builds, but the testmain code fails to link properly.</h4>
A proper solution for this problem has not been found yet (suggestions
are welcome),
but James Emery reported success with the following workaround:
<ul>
<li>Disable building of the static library</li>
<li>Change the linker from /usr/ucb/ld to CC and enable 'place
independent code' (pic).</li>
</ul>
In short, configure with:<br>
<pre class="code">export LD="CC -Kpic" &amp;&amp; ./configure --disable-static</pre>
<h4>4.3. ./configure fails to detect 'snprintf()' on platform XYZ.</h4>
./configure does not just check for the presence of a snprintf()
function but for C99 compliancy as well. In particular, snprintf()
should strictly honour the 'string size' parameter to avoid potential
buffer overflow problems.
log4cpp falls back to an <a href="http://www.ijs.si/software/snprintf/">alternative
snprintf() implementation</a> if the OS does not provide a
correct one.
<p><br></p>
<a href="#begin">^</a>
</div>

<div class="chapter">
<h2><a id="simpleexample">Simple example
</a></h2>
<p>Sample main.cpp file that logs onto console and into file program.log. Loggers and appenders are created and configured manually. Example makes use of both function-style logging and stream-style logging.
</p>
<pre class="code">
// main.cpp

#include "log4cpp/Category.hh"
#include "log4cpp/Appender.hh"
#include "log4cpp/FileAppender.hh"
#include "log4cpp/OstreamAppender.hh"
#include "log4cpp/Layout.hh"
#include "log4cpp/BasicLayout.hh"
#include "log4cpp/Priority.hh"

int main(int argc, char** argv) {
	log4cpp::Appender *appender1 = new log4cpp::OstreamAppender("console", &std::cout);
	appender1->setLayout(new log4cpp::BasicLayout());

	log4cpp::Appender *appender2 = new log4cpp::FileAppender("default", "program.log");
	appender2->setLayout(new log4cpp::BasicLayout());

	log4cpp::Category& root = log4cpp::Category::getRoot();
	root.setPriority(log4cpp::Priority::WARN);
	root.addAppender(appender1);

	log4cpp::Category& sub1 = log4cpp::Category::getInstance(std::string("sub1"));
	sub1.addAppender(appender2);

	// use of functions for logging messages
	root.error("root error");
	root.info("root info");
	sub1.error("sub1 error");
	sub1.warn("sub1 warn");

	// printf-style for logging variables
	root.warn("%d + %d == %s ?", 1, 1, "two");

	// use of streams for logging messages
	root << log4cpp::Priority::ERROR << "Streamed root error";
	root << log4cpp::Priority::INFO << "Streamed root info";
	sub1 << log4cpp::Priority::ERROR << "Streamed sub1 error";
	sub1 << log4cpp::Priority::WARN << "Streamed sub1 warn";

	// or this way:
	root.errorStream() << "Another streamed error";

	return 0;
}
</pre>
Console output for that example
<pre class="code">
1352973121 ERROR  : root error
1352973121 ERROR sub1 : sub1 error
1352973121 WARN sub1 : sub1 warn
1352973121 WARN  : 1 + 1 == two ?
1352973121 ERROR  : Streamed root error
1352973121 ERROR sub1 : Streamed sub1 error
1352973121 WARN sub1 : Streamed sub1 warn
1352973121 ERROR  : Another streamed error</pre>
<a href="#begin">^</a>
</div>

<div class="chapter">
<h2><a id="propfile">Properties file example</a></h2>
<p>Sample main.cpp file that makes use of logging configuration file log4cpp.properties
</p>
<pre class="code">
// main.cpp

#include &lt;log4cpp/Category.hh>
#include &lt;log4cpp/PropertyConfigurator.hh>

int main(int argc, char* argv[])
{
	std::string initFileName = "log4cpp.properties";
	log4cpp::PropertyConfigurator::configure(initFileName);

	log4cpp::Category& root = log4cpp::Category::getRoot();

	log4cpp::Category& sub1 = 
		log4cpp::Category::getInstance(std::string("sub1"));

	log4cpp::Category& sub2 = 
		log4cpp::Category::getInstance(std::string("sub1.sub2"));

	root.warn("Storm is coming");

	sub1.debug("Received storm warning");
	sub1.info("Closing all hatches");

	sub2.debug("Hiding solar panels");
	sub2.error("Solar panels are blocked");
	sub2.debug("Applying protective shield");
	sub2.warn("Unfolding protective shield");
	sub2.info("Solar panels are shielded");

	sub1.info("All hatches closed");

	root.info("Ready for storm.");

	log4cpp::Category::shutdown();

	return 0;
}
</pre>

<p>Configuration file for use with that code</p>
<pre class="code">
# log4cpp.properties

log4cpp.rootCategory=DEBUG, rootAppender
log4cpp.category.sub1=DEBUG, A1, A2
log4cpp.category.sub1.sub2=DEBUG, A3

log4cpp.appender.rootAppender=ConsoleAppender
log4cpp.appender.rootAppender.layout=PatternLayout
log4cpp.appender.rootAppender.layout.ConversionPattern=%d [%p] %m%n 

log4cpp.appender.A1=FileAppender
log4cpp.appender.A1.fileName=A1.log
log4cpp.appender.A1.layout=BasicLayout

log4cpp.appender.A2=FileAppender
log4cpp.appender.A2.threshold=WARN
log4cpp.appender.A2.fileName=A2.log
log4cpp.appender.A2.layout=PatternLayout
log4cpp.appender.A2.layout.ConversionPattern=%d [%p] %m%n 

log4cpp.appender.A3=RollingFileAppender
log4cpp.appender.A3.fileName=A3.log
log4cpp.appender.A3.maxFileSize=200
log4cpp.appender.A3.maxBackupIndex=1
log4cpp.appender.A3.layout=PatternLayout
log4cpp.appender.A3.layout.ConversionPattern=%d [%p] %m%n 
</pre>
Console output for that example
<pre class="code">
2012-11-14 18:44:58,163 [WARN] Storm is coming
2012-11-14 18:44:58,166 [DEBUG] Received storm warning
2012-11-14 18:44:58,170 [INFO] Closing all hatches
2012-11-14 18:44:58,172 [DEBUG] Hiding solar panels
2012-11-14 18:44:58,175 [ERROR] Solar panels are blocked
A3.log.1
2012-11-14 18:44:58,179 [DEBUG] Applying protective shield
2012-11-14 18:44:58,183 [WARN] Unfolding protective shield
2012-11-14 18:44:58,186 [INFO] Solar panels are shielded
2012-11-14 18:44:58,190 [INFO] All hatches closed
2012-11-14 18:44:58,192 [INFO] Ready for storm.
</pre>

<p>There are three loggers (including root) and three appenders. Root logger redirects all its own input and input of its descendant onto console.
Descendant sub1 writes into two files, filtering output by message priority for second of them. Descendant sub1.sub2 writes also into rolling file. 
Log file A3.log is rolled over as soon as it reaches limit of 200 bytes, 1 backup log file is kept.
</p>

<a href="#begin">^</a>
</div>

<div class="chapter">
<h2><a id="cvs">CVS Repository</a></h2>
<p>Log4cpp is also available directly through CVS, see the <a href="http://sourceforge.net/cvs/?group_id=15190">SourceForge CVS page</a> for instructions.
CVS currently has two branches:
</p>
<p></p><table>
<tbody><tr><td>MAIN</td><td>for log4cpp development</td></tr>
<tr><td>BRANCH_MAINT_0_2</td><td>for maintainance of log4cpp-stable (0.2.x)</td></tr>
</tbody></table><br>
Each release will receive a tag named REL_x_y_z.
<p></p>
<p>To start working with a freshly checked out log4cpp revision, run <b>./autogen.sh</b>
 first. This will create ./configure and the necessary Makefile.in's. 
You'll need at least autoconf 2.50, automake 1.6.0 and libtool 1.4.
</p> 
<a href="#begin">^</a>
</div>

<div class="chapter">
<h2><a id="releases">Releases</a></h2>
<p>
WARNING: releases from the development branch are a 'work in progress' and may fail to build, crash or redecorate your desktop.
</p>
<small>
<dl>
<dt>1.1.2rc1 - master branch (04 April 2015)</dt>
<dd>Small fixes, DailyRollingFile appender, tests, options to disable support for smtp and syslog</dd>
</dl>

<dl>
<dt>1.1.1 - stable branch (26 November 2013)</dt>
<dd>Small code and project file fixes.</dd>
</dl>

<dl>
<dt>1.1rc3 - development branch (18 October 2012)</dt>
<dd>Created build projects for MSVC10 (VS2010).</dd>
<dd>Small code fixes.</dd>
</dl>

<dl>
<dt>0.3.4 - development branch (28 October 2002)</dt>
<dd>Fixed builds for MSVC6 and MSVC7.</dd>
<dd>Removed Log4cppCleanup.</dd>
</dl>

<dl>
<dt>0.3.3 - development branch (26 October 2002)</dt>
<dd>Fixed #628211: build failure on MSVC 6.0.</dd>
<dd>Fixed #625811: log facility in RemoteSyslogAppender.</dd>
<dd>Possibly fixed #415160: crashes with dynamic library on Solaris 2.6.</dd>
<dd>Replaced PatternLayout with a new, faster and more complete implementation.</dd>
</dl>

<dl>
<dt>0.3.2 - development branch (5 October 2002)</dt>
<dd>Fixed #614903: compilation problem on Sun CC 5.3.</dd>
<dd>Added missing MSVC6 .dsp files.</dd>
<dd>Fixed log facility in RemoteSyslogAppender.</dd>
<dd>Fixed relocatability of log4cpp-devel RPM.</dd>
<dd></dd>
</dl>

<dl>
<dt>0.3.2rc5 - development branch (5 October 2002)</dt>
<dd>Merged #604991: support for setting additivy in PropertyConfig.</dd>
<dd>Merged #605143: support for compilation in QNX Neutrino.</dd>
</dl>

<dl>
<dt>0.3.2rc4 - development branch (16 August 2002)</dt>
<dd>Fixed last minute goof ups which prevented compilation on both *nix and Win32 platforms.</dd>
</dl>

<dl>
<dt>0.3.2rc2 - development branch (12 August 2002)</dt>
<dd>Added support for POSIX threads.</dd>
<dd>Added PropertyConfigurator.</dd>
<dd>Rearranged documentation.</dd>
<dd>Fixed various bugs.</dd>
</dl>

<dl>
<dt>0.3.2rc1 - development branch (19 June 2002)</dt>
<dd>Support for Win32 threads added.</dd>
<dd>Added NTEventLogAppender.</dd>
<dd>Added Win32DebugAppender.</dd>
<dd>Fixed NDC context problem if depth &gt; 2.</dd>
<dd>Added aclocal support.</dd>
</dl>

<dl>
<dt>0.3.1 - development branch (4 April 2002)</dt>
<dd>Added RollingFileAppender class.</dd>
<dd>Fixed bug #572467: invalidated iterator usage.</dd>
<dd>Fixed bug #527475: format string bug.</dd>
<dd>Fixed bug #530332: missing 'std::' specifiers.</dd>
<dd>Handled feature requests #536668, #527760, #527381.</dd>
</dl>

<dl>
<dt>0.3.0 - development branch (18 Februari 2002)</dt>
<dd>Added experimental support for multi threaded applications. This implementation uses omniORB4s threading library.
Other threading libraries, such as Boosts, may be used as well, but this has not been implemented yet.</dd>
</dl>

<dl>
<dt>0.2.7 - stable branch (27 Januari 2002)</dt>
<dd>Support for multiple Appenders per Category added (feature request #501360).</dd>
<dd>Fixed variable scope bug in SyslogAppender (bug #499315)</dd>
<dd>Fixed memory leak in SyslogAppender and RemoteSyslogAppender (bug #499524)</dd>
<dd>Fixed compile problem in Filter (bug #)</dd>
<dd>Fixed config file parse problem in SimpleConfigurator (bug #500766)</dd>
<dd>Added methods for logging at FATAL level (bug #504314)</dd>
<dd>Fixed Win32 compile problem (bug #506907)</dd>
</dl>

<dl>
<dt>0.2.6 (11 December 2001)</dt>
<dd>Preliminary support for OpenVMS added.</dd>
<dd>PatternLayout, SimpleConfigurator and RemoteSyslogAppender added.</dd>
</dl>

<dl>
<dt>0.2.5 (11 June 2001)</dt>
<dd>Inclusion of support for Borland C++ Builder.</dd>
<dd>Library version 1.0.0: this release is not binary compatible with 
previous ones. (Version update should have been done in 0.2.4).</dd>
</dl>

<dl>
<dt>0.2.2 (04 March 2001)</dt>
<dd>Inclusion of Win32 platform (MSVC++ 6.0)</dd>
</dl>

<dl>
<dt>0.2.1 (15 Februari 2001)</dt>
<dd>license change to LGPL.</dd>
</dl>

<dl>
<dt>0.2.0 (10 December 2000)</dt>
<dd>log4cpp now uses autoconf and automake.</dd>
</dl>
<p></p>
</small>
<a href="#begin">^</a>
</div>

<div class="chapter">
<h2><a id="status">Status</a></h2>
<p>The latest stable release is 1.1.1</p>
<small>
<p>log4cpp is moved to git since version 1.1.1, cvs is stale since then</p>
<p>As of version 0.3.0 log4cpp has a separate 'stable' and 'development' branches.
Releases x.y.z where y is even are considered stable and those where y is odd are experimental
(which means that some or all features may be broken).</p>
<p>Releases of 0.2.x are for bug 
fixes only, new features will go into 0.3.x and eventually 0.4.x.</p> </small>
<a href="#begin">^</a>
</div>

<div class="people">
<h2><a id="people">People</a></h2>
<p>Coding on Log4cpp was initiated by me (Bastiaan Bakker) late 2000. 
Since then other people have joined the project or contributed code:
</p><table>
<tbody><tr><td>Cedric Le Goater &lt;cedric(at)legoater.com&gt;</td><td>autoconf setup, various improvements</td></tr>
<tr><td>Marc Welz &lt;marc(at)jade.cs.uct.ac.za&gt;</td><td>IdsaAppender</td></tr>
<tr><td>Lynn Owen &lt;opl(at)agoby.com&gt;</td><td>MSVC++ support</td></tr>
<tr><td>Steve Ostlind &lt;s.ostlind(at)pentasafe.com&gt;</td><td>MSVC++ support, various fixes</td></tr>
<tr><td>Marcel Harkema &lt;marcel(at)debian.org&gt;</td><td>Debian packaging</td></tr>
<tr><td>Uwe Jäger &lt;jaeger(at)varial.de&gt;</td><td>Borland C++ Builder support</td></tr>
<tr><td>Walter Stroebel &lt;walter.stroebel(at)lifeline.nl&gt;</td><td>RemoteSyslogAppender</td></tr>
<tr><td>Glen Scott &lt;glen_s(at)yahoo.com&gt;</td><td>PatternLayout, SimpleConfigurator</td></tr>
<tr><td>Tony Cheung &lt;dragonman(at)asiayeah.com&gt;</td><td>OpenVMS support</td></tr>
<tr><td>Alex Tapaccos &lt;ATapaccos(at)redfig.com&gt;</td><td>DailyRollingFileAppender</td></tr>
<tr><td>Brendan B. Boerner &lt;bboerner(at)texas.net&gt;</td><td>Multiple Appender support for Categories</td></tr>
<tr><td>Paulo Pizarro &lt;paulo.pizarro(at)digitro.com.br&gt;</td><td>RollingFileAppender</td></tr>
<tr><td>David Resnick &lt;dresnick(at)mobilespear.com&gt;</td><td>NTEventAppender, integration work</td></tr>
<tr><td>Aaron Ingram &lt;ai8(at)yahoo.com&gt;</td><td>MSThreads support</td></tr>
<tr><td>Alan Anderson &lt;alan(at)rushmore.com&gt;</td><td>Win32DebugAppender, PropertyConfigurator</td></tr>
<tr><td>Emiliano Martin &lt;emilianomc(at)terra.es&gt;</td><td>PThreads support</td></tr>
<tr><td>Alexander Perepelkin &lt;sanchouss_(at)users.sf.net&gt;</td><td>Project maintenance, improvements, fixes</td></tr>
</tbody></table>
<p></p>
<a href="#begin">^</a>
</div>

<div class="chapter">
<h2><a id="projectpages">Project Pages</a></h2>
<p>
</p><table border="0">
<tbody><tr><td><a href="http://sourceforge.net/"> <img src="sflogo.png" alt="SourceForge Logo" align="left" border="0"></a></td>
<td>Log4cpp is hosted on <a href="http://sourceforge.net/">SourceForge</a><a> at </a><a href="http://sourceforge.net/projects/log4cpp/">http://sourceforge.net/projects/log4cpp/</a>.</td></tr>
</tbody></table>
<p></p>
<a href="#begin">^</a>
</div>

<div class="chapter">
<h2><a id="other">Other
projects</a></h2>
<p>Log4cpp is one of many ports/implementations of the Log4j API. Here's an incomplete list:
  </p><table>
     <tbody><tr><td><a href="http://log4c.sourceforge.net/"><b>log4c</b></a></td><td>An implementation in C by Cedric Legoater</td></tr>
     <tr><td><a href="http://log4cplus.sourceforge.net/"><b>log4cplus</b></a></td><td>An indepent C++ implementation by Tad Smith.
     Worth checking out if you don't like Log4cpp for some reason.</td></tr>
   </tbody></table><p></p>
<a href="#begin">^</a>
</div>
<!--
<div class="chapter">
<h2><a id="id">Chapter</a></h2>
<p>Log4cpp Chapter
</p>
<a href="#begin">^</a>
</div>
-->

</div>
</div>
</div>
</body></html>